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This invention relates to managing multiple web servers, and more particularly to a web 
;i20 service system that allows a system operator to distribute content to each web server in the web 
service system. 

Jj Background Information 

In a computer network environment, web servers are used to respond to users' web page 
25 requests, which are transmitted over the computer network. Web page requests, also referred to 
as content requests, typically are made by a browser running on a user's computer. A web server 
monitors one or more computer network address/port endpoints for web page requests and 
responds to the web page requests by transmitting web pages to the requester. Web servers may 
be special purpose devices, or they may be implemented a software program running on a 
30 general purpose computer. The service capacity of a web server limits the number of web page 
requests that may be received and responded to in a given time interval. 

A web service system may include one web server or more than one web server. 




Generally, when a web service system includes more than one web server, the web service 
system is designed so that the multiple web servers each respond to web page requests. 
Typically, a user's web page request is directed towards one of the web servers, and that web 
server responds to that web page request. It is also typical for web service systems designed to 
5 receive a large number of web page requests to include many web servers. 

In general, in a system with multiple web servers, a system operator or operators manage 
the content offered by the various web servers. A system operator may sometimes wish to 
coordinate the content on the system, for example, to make sure that the content on various web 
servers is identical, or to have some content available from one web server and other content 
10 available from another web server. This can be difficult to accomplish, especially if content 

updates are to be transparent to users, who can potentially be in the middle of an interaction v^th 
the system involving a series of related web pages. 
Q Managing content is also a problem for caching servers. Caching servers "cache", or 

i : i temporarily store, the results of requests relayed from a browser to a web server for use in 
:/i5 satisfying subsequent identical requests. A challenge in caching server design and operation is 
^•H determining when the stored (cached) content is no longer consistent vnth the content on the 
i:::= orfginal server, that is, when the cached content is invalid. The hypertext transfer protocol 

("http") includes a mechanism for the original server of some content to specify the duration for 
1=^^ which a cache server shouldjet ain a co py of thej^ontent. For some ^oirtent, however, it is not 
i:j20 possible for the originalservert^ how long the content vyill 

*Tj remain valid, and there may be times when content is unexpectedly updated sooner than the 
expiration time specified by the original server. 

Summary of the Invention 

25 In a web service system with one or many web servers, a system and method for 

managing and distributing the content on the one or more web servers is usefiil to a system 
operator. For example, content updates are often desired to be performed on a rapid basis. 
Scheduling and automation can be used to update content on the servers in an efficient and 
consistent manner. Also, it is helpfiil to identify content update failures, take a failed server out 

30 of service, fix it, and return it to service in the web service system as quickly as possible. It is 
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desired to maximize web site availability, even as updates occur, v^hile minimizing disruption of 
transactions. Changes may require that a server be restarted,tfor example if the content is served 
using a shared library that will not be unloaded (and/or updated) tmtil the web server process(es) 
exit. 

5 A web service system according to the invention correctly and efficiently updates 

changed content on the one or more web servers in the system, so that the changes are consistent 
among the web servers and so that the changes do not require excessive network bandwidth. 
This is accomplished such that the content change is not noticeable to a browser engaged in a 
transaction with a web server, and so that content versions are preserved, both for consistency of 
10 transactions started using older content, and so that a web server can revert to the older content if 
there is a problem with an update. A web service system of the invention also can track content 
changes, and notify caching servers as appropriate that cached content has become invalid. 

0 Generally, in one aspect, the invention relates to a system and met h^dfq r replicatin g 

1 i I chan ges in a source file se t on a destination file system. Changes in a source file set are 

,15 identified. Th e chan ges are stored i n a modification l ist. The modification list is transmitted to 
■^^ ' an agent having access to a dest ination file syst em. In one embodiment, the changed files are 
I :==b transT^^ to the agent. In anothejr^mbodm the changed files are installed on the 
r\ *^^^!BSJLSl£l£^stem. In another embodiment, the changes are identified by inspecting a set of 
1^^=^ files and comparing the set of files to an earlier-recorded set. In another embodiment, the 
JO changes are identified by installing a device driver to perform file operations and by recording, 
. p5 by the device driver, changes to the source file set. In another embodiment, the changes are 
identified by receiving a manifest describing changes to the source file set. In another 
embodiment, the files are compared by comparing a file attribute to the file attribute of the 
earlier-recorded set. In one embodiment, the file attribute comprises at least one attribute chosen 
25 from the set of file size, file permissions, file ownership, modification time, and a hash of the 
file. In another embodiment, the method includes calling a script before identifying the changes. 
In another embodiment, the method includes calling a script before transmitting the changes. In 
another embodiment, the method includes calling a script after transmitting the changes. In 
another embodiment, the method includes calling a script after determining whether the 
30 transmission has completed successfully. 




In general, in another aspect, the invention relates to a system and method for replicating 
changes in a source file set on a destination file system. Changes in a source file set are 
identified. The identified changes are stored in a modification list including uniform resource 
locators specifying the changed files. The modification list is transmitted to at least two web 
5 servers. In one embodiment, the transmission is accomplished by multicasting. In one 

embodiment, the changes are identified by inspecting a set of files and comparing the set of files 
to an earlier-recorded set. In another embodiment, the files set is compared to an earlier-recorded 
set by comparing a file attribute to the file attribute of the earlier-recorded set. In another 
embodiment, the file attribute comprises at least one attribute chosen from the set of file size, file 
10 permissions, file ownership, modification time, and a hash of the file. 

In general, in another aspect, the invention relates to a web service system. The system 
includes a manager for managing the web service system. The system also includes a host 
Q comprising a web server for receiving web page requests and an agent in conununication with the 
h I manager. The system also includes a content distributor for providing content changes to the 
, |5 host. In one embodiment, the system includes an traffic manager for directing web page 
iii^ requests. In another embodiment, the content distributor includes an identification module for 
identifying changes in a source file set, a modification list for storing identified changes; and a 
transmitter for transmitting the modification list to an agent having access to a destination file 
^^^^ system. In another embodiment, the system includes a transmitter for transmitting the changed 
ijilO files to the agent. In another embodiment, the agent includes an installer for installed the 
' changed files on the destination file system. 

In general, in another aspect, the invention relates to a content distributor. The content 
distributor includes an identification module for identifying changes in a source file set. The 
content distributor also includes a modification list for storing identified changes. The content 
25 distributor also includes a transmitter for transmitting the modification list to an agent having 
access to a destination file system. In one embodiment, the content distributor includes a 
transmitter for transmitting the changed files to the agent. 

The foregoing and other objects, aspects, features, and advantages of the invention will 
become more apparent from the following description. 

30 
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Brief Description of the Drawings 
In the drawings, like reference characters generally refer to the same parts throughout the 
different views. Also, the drawings are not necessarily to scale, emphasis instead generally being 
placed upon illustrating the principles of the invention. 
5 FIG. 1 is a block diagram of an embodiment of a web service system according to the 

invention. 

FIG. 2 is more detailed block diagram of an embodiment of a web service system. 

FIG. 3 is a flowchart of the operation of an embodiment of the content distributor of FIG. 

1. 

10 FIG. 4 is a flowchart of a comparison of the current source file set and a previous file set. 

FIG. 5 is an embodiment of a manifest entry. 

FIG. 6 is an example list of changed files, 
i -) FIG. 7 is an example embodiment of a manifest showing the changed files of FIG. 6. 

; j FIG. 8 is an example of an embodiment of old version maintenance. 

15 FIG. 9 is a block diagram of an embodiment of a web service system in communication 

with a caching server. 

:=i FIG. 1 0 is a flowchart of an embodiment of a method for distributing content. 

= 1 FIG. 1 1 is a flowchart of the operation of another embodiment of the content distributor. 

^=^" FIG. 12 is a flowchart of the operation of another embodiment of the content distributor. 

j|0 FIG. 13 is an example of the information provided to a script in the embodiment of FIG 

i:; 12. 



Description 

A system for serving web pages has a plurality of web servers and provides a system 
25 operator v^th features and tools to coordinate the operation of multiple web servers. The system 
might have only one web server, but typically it includes more than one. The system can manage 
traffic by directing web page requests, which originate, generally, from web browsers on client 
computers, to available web servers, thus balancing the web page request service load among the 
multiple servers. The system can collect data on web page requests and web server responses to 
30 those web page requests, and provides reporting of the data as well as automatic and manual 



analysis tools. The system can monitor for specific events, and can act automatically upon the 
occurrence of such events. The events include predictions or thresholds that indicate impending 
system problems. The system can include crisis management capability to provide automatic 
error recovery, and to guide a system operator through the possible actions that can be taken to 
5 recover from events such as component failure or network environment problems. The system 
can present current information about the system operation to a system operator. The system can 
manag econtent replicat ion witlrve^ data updates. Some or all of this 

functionality can be provided in specific embodiments. 

Referring to FIG. 1, an embodiment of a web service system 90 receives web page 
10 requests from a browser 1 . In this context, a web page is electronic content that can be made 
available on a computer network 2 in response to a web page request. Requests typically 
originate from web browsers 1 . An example of a web page is a data file that includes computer 
Lj executable or interpretable information, graphics, sound, text, and/or video, that can be 
I ; J displayed, executed, played, processed, streamed, and/or stored and that can contain links, or 
,15 pointers, to other web pages. The requests are communicated across a communications network 
u 1 2. In one embodiment, the communications network 2 is an intranet. In another embodiment, 
the communications network 2 is the global communications network known as the Internet. A 
browser 1 can be operated by users to make web page requests. Browsers 1 can also be operated 
by a computer or computer program, and make requests automatically based on the computer's 
:J|0 programming. The web page requests can be made using hypertext transfer protocol ("http") 
% format, and also can be made using other protocols that provide request capability. 

Referring to FIG. 2, an embodiment of a web service system 90, includes various 
components 100-126. The components communicate over one or more computer networks. The 
physical location of the components does not impact the capability or the performance of the 
25 system, as long as the communications links between the various components have sufficient 
data communication capability. The web service system 90 can fixnction across firewalls of 
various designs, and can be configured and administered remotely. 

The web service system 90 manages one or more hosts 100. One host 100 is shown as an 
example. An embodiment of the web service system 90 can have any nimiber of hosts 100. 
30 Each host 100 can be a computer system commercially available and capable of using a multi- 
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threaded operating system such as UNIX or Windows NT. Each host 100 can have at least one 
network connection to a computer network, for example the Internet or an intranet, or any other 
network, that allows the host 100 to provide web page data in response to web page data 
requests. Each host 100 includes at least one web server 102. 
5 The web server 102 can be any web server that serves web pages in response to web page 

requests received over a computer network. Two examples of such web servers are 
commercially available as the NETSCAPE ENTERPRISE SERVER, available from Netscape 
Communications Corporation of Mountain View, California and the MICROSOFT INTERNET 
INFORMATION SERVICES SERVER, available from Microsoft Corporation of Redmond, 
10 Washington. The web server 102 is capable of receiving web page requests from web clients, 
also referred to as browsers and/or web page requesters. A web page request from a browser is 
also referred to as a content request, or from the point of view of a web server, as a "hit." Often 
the web page requests are part of a series of communications with the web server 1 02 involving 
i i J several requests and responses. One such series, referred to as a session, is an extended 
15 interaction with the web server. A shorter interaction, for example the purchase of an item, is 
^ referred to as a transaction. A session could involve several transactions. The user interacts with 
i-^ a web server 102 by making an initial request of the web server 102, which results in the web 
h-^ server 102 sending a web page in response. The web page can contain information, and also 
pointers to other requests that the user can make of the web server 102 or perhaps other web 
iJ20 servers. Sometimes the requests are for information that must be retrieved from a database, and 
; j;i sometimes the request includes information to be stored in a database. Sometimes the request 
requires processing by the web server 102, or interaction with another computer system. 
Sophisticated web servers and browsers can interact in various ways. 

An aggregation of related web pages presented to a user as a set of web pages about a 
25 related topic, or from a particular source, usually, but not always from the same web server 102, 
is referred to as an application. One example of an application is a set of pages providing 
information about a company. Another example of an application is a series of pages that allow 
a user to conduct transactions with her savings bank. Two sets of web pages may be considered 
a single application, or they can be considered two separate applications. For example, a set of 
30 web pages might provide information about a bank, and a customer service set of web pages 



might allow transaction of business with the bank. Whether a set of web pages is considered to 
be one application or several applications is a decision made by the application designer. The 
web service system 90 is capable of delivering one or more applications to users. The web 
service system 90 can be configured so that some subset of the web servers 102 exclusively serve 
5 a single application. In one embodiment, some web servers 102 serve a subset of the available 
applications, and other web servers 102 serve other applications. In another embodiment, all 
web servers 102 serve all available applications. 

The web pages that are presented to the user in response to web page requests from the 
user's web browser can be stored on the host 100 or on a file system accessible to the web server 
10 102. Some or all of the web page content can be generated by the web server 1 02 by processing 
data available to the web server 102. For example, for web pages that are docimients about a 
topic, the web pages can be created (designed) and stored in the web server 102 file system. In 

0 response to a web page request, such a web page can be sent to the user just as it is stored in the 
ij I file system. In a banking transaction system, however, it is likely that information about the 
./|5 user's bank accoimt will be stored in a database. The web server 102 can generate a web page 

1 n containing the user's account information each time the user requests the page. Often, web pages 
hi= are stored partially in the file system, and partly are generated by the web server 102 when the 

i request is made. 

Various techniques are used to store status information, also referred to as the "state" of a 

ii20 user's session with the web server 102. The user can develop a state during her interaction with 

"f\ the web server 102 via the requests made to the web server 102 and the web pages received in 
response to those requests. The user's state can, as one example, include information identifying 
the user. As another example, the state can include information specifying web pages the user 
has already requested, or the options the user has selected in her interaction with the system. As 

25 another example, the state can include items the user has selected for purchase from a 

commercial sales application. Generally some information about or identifying the state of the 
session is stored in the client web browser, for example as a cookie as described below, and some 
information can be stored in the web server 102. 

A host 100 can have any number of web servers 102 running on it, depending on host 

30 capacity, performance, and cost considerations. In one embodiment, the host 100 includes one 



web server 102. In other embodiments, a host includes more than one web server 102. The one 
web server 102 on host 100 is a simplified illustrative example and are not intended to limit the 
number of possible web servers 102. Each web server 102 monitors at least one network address 
and port, also referred to as an endpoint. A particular address and port is called an endpoint 
5 because it is a virtual endpoint for communication — a network connection is made between one 
address/port endpoint and another. A web server 102 receives requests directed to one of its 
endpoints and responds to those requests with data in the form of web pages. 

A web server 102 that accepts requests at multiple network address/port endpoints can 
perform as if it were a plurality of distinct web servers 102 even though it is actually 
10 implemented as one web server 102. Such a web server is referred to as a multiple endpoint web 
server. For the purposes of this discussion, a multiple endpoint web server can be described as if 
it were in fact multiple web servers 102 v^th each web server 102 receiving requests on a 
network address/port endpoint. In one embodiment, such a multiple endpoint web server has one 

1 1 j web server interface 104 that is the interface for all of the multiple endpoints. 

As Each web server 102 can have associated with it a web server interface 104. The web 

server interface can be a plug-in, filter, or other software associated v^th the web server 102 that 

1=-^ serves as an interface between the web server 102 and other components of web service system 

1 = 1 90. In this context, the term web server interface is distinct fi-om the network interface that can 
be present on the host 100. For example, the web server 102 has a web server interface 104. 

i=j20 Each web server interface 104 can communicate with an agent 106 on each host 100. 

j pi A host 100 includes an agent 106. The agent 106 provides a web service system 90 

interface with the host 100. The agent 106 links the web server interface 104 with the web 
service system 90. The agent 106 also links the host 100 with the web service system 90. Even 
on a host that has multiple web servers, there is generally only one agent 106 running on the host 
25 100, however it is possible to have more than one. Each agent 106 has access to a database 108, 
which contains information about the system components. 

The agent 106 on a host 100 communicates v^th a web service system manager 110. The 
manager 110 receives information fi-om the agents 106 about the status of the hosts 100 and the 
web servers 102. The manager 1 10 can send commands to the agents 106 to configure the hosts 
30 100, to start, stop, or pause the web servers 102, and to manage the load on the web servers 102. 



The manager 1 10 has access to a logging database 1 14 that is used for logging system activity 
and events. The manager 1 10 also has access to a managed object database 1 12, used for storing 
information about the various components of the system. The manager 1 10 is also in 
communication with one or more consoles 1 16A-1 16X, generally referred to as 1 16. The 
5 consoles 1 16 provide a user interface for the system operator. The system operator can monitor 
the status of the system and configure the system via a console. The manager 1 10 can be run on 
the same host 100 as other web service system 90 components, such as one of the web servers 
102 or a traffic manager 120, or on another computer of sufficient capacity. 

The manager 1 10 communicates with a traffic manager 120, also referred to as an 
10 interceptor. The traffic manager 120 directs web page requests to a web server. The invention is 
not restricted to any particular type of traffic manager 120, but rather is intended to work with 
any sort of traffic manager 120 that directs web page requests to web servers 102. 
Q In one embodiment, the traffic manager 120 receives information and commands from 

1 1 j the manager 1 10. The traffic manager 120 also receives information and commands from a 
.15 control program 122. The traffic manager control program can be on the same computer system 
as the traffic manager 120, or alternatively it can run on another system. The traffic manager 120 
receives web page requests and refers the requests to one of the web servers. Part of the 
management capability of the web service system 90 is accomplished by monitoring the web 
'f'^ page requests made of the web servers 102 and the resulting load on the web servers 102 and the 
i:j20 hosts 100. Web page requests can be directed to balance the load among the web servers 102. In 
jj j one embodiment, the traffic manager 120 is the point of first contact for a user. The traffic 

manager 120 receives a web page request from a user and "refers" the user's web browser to an 
appropriate web server 102 for that request. The user's web browser is referred by responding to 
the web page request with a referral to a web page on an appropriate web server 102. This 
25 referral capability can be accomplished with a capability incorporated into the hypertext transfer 
protocol, but can also be accomplished in other ways. The user may or may not be aware that the 
web browser has been referred to an appropriate web server 102. The user accesses the 
application on that web server 102 and receives responses to its web page request from that web 
server 102. In one embodiment, if a web server 102 becomes overloaded, that web server 102, 
30 under the direction of the manager 1 10, can refer the user back to the traffic manager 120 or to 



another web server 102 capable of delivering the application. 

The traffic manager 120 receives requests from users and redirects the user's requests to 
web servers 102. In one embodiment, the traffic manager 120 is used to direct all users to one 
web server 102, such as another traffic manager 120 or a single endpoint. In this manner, the 
5 traffic manager 120 acts as a shunt, meaning it directs all requests directed towards one or more 
web servers on a host to another web server 102, In another embodiment, the traffic manager 
120 receives status information from the manager 110 and uses that information to redirect users. 
The status information includes server availability and load, administrator's changes, and 
application or web server 102 start and shut down actions. The traffic manager 120 is designed 
10 for speed and security. The traffic manager 120 is often the front door to the system, and so its 
performance affects the perceived performance of the entire web service system 90. It may be 
useful to locate the traffic manager 120 as close, in the network topology sense, to the backbone 
ul as possible. It is then necessarily the most exposed component of the web service system 90. 
i J In one embodiment, the traffic manager 120 is implemented in hardware. In another 

/is embodiment, the traffic manager 120 is a software program running on a host computer. In one 
iji software embodiment, the traffic manager 120 is a standalone program that runs on a server-class 
computer capable of rurming a multi-threaded operating system. Under UNIX, for example, the 
traffic manager 120 can run as a daemon. Under Windows NT^'^, the traffic manager 120 can 
^■H run as a service. 

;.]20 In another embodiment, the traffic manager 120 is an internet protocol bridge or router 

that directs requests made to one endpoint to the endpoint belonging to a web server 102. In this 
way, the traffic manager 120 directs the web page requests to one or more web servers 102. An 
example of such a traffic manager is the LOCALDIRECTOR available from Cisco Systems, Inc. 
of San Jose, California. In yet another embodiment, the traffic manager 120 is a web switch, 
25 such as a CONTENT SMART WEB SWITCH available from Arrowpoint Communications, Inc. 
of Westford, Massachusetts. The traffic manager 120 receives each web page request and, based 
on the request, directs the request to a web server. 

The web service system 90 also includes a version controller, also referred to as a content 
/ distributor 125. The content distributor 1 j S jmanages v ersion and c ontent replicatio n, including 
30 cont ent upda tes on the various web servers K)2 in thejwebjeryice system 90. A system operator 



interface to the content distributor 125 is provided by a content control 126. In one embodiment, 
the content distributor 125 and the content control 126 are each a stand-alone process that 
operates on the host 100. In another embodiment, the content distributor 125 and the content 
control 126 operate on the same host as the manager 110. In still other embodiments, content 
5 distributor 125 and the content control 126 operate on other hosts. The content distributor 125 
and the content control 126 can operate on the same host, or on a different host. In other 
embodiments, the content distributor 125 is incorporated into the functionality of the manager 
1 10, or other components of the system 90. 

The content distributor 125 transmits information to the agent 106, and through the agent 
10 106 to the web server interface 104. The transmitted information describes changes to a set of 
c ontent directories and files that are rgfeged t^^ and are generally organized in 

a hierarchical directo ry structure. These source files are the "master" copy of the content for the 
^ jjj webservers. Together, the directories and files^are^ref^ the 
1 j i source file set. The source file set can be stored on a source host, also referred to as a staging 
= .15 serv^vvyhich is typically^but^noyiecessarily, the host on which the content distributor 125 is 
;^ ' running. For simplicity of explanation, in the following discussion, content directories and files, 
either the source files or on a host 100, generally are referred to jus^asfiles. The source file set 
m can include both directories and files, and changes to the files can also include the addition, 
: -f deletion, and modification of directories. 

y20 Referring to FIG. 3, changes are made over some period of time to the source file set 

: 11 (STEP 180). The changes that are made include such changes as the creation of new files, 

del etion^ o ld files, replacement of existing files with new content (i.e. modifying file content), 
and modifying file attributes such as permission restriction and ownership. Again, although 
changes to files are described, it is intended that changes to directories also are included. 
25 Changes are made by editing the files using such editing techniques and tools known in the art, 
including application programs and operating system utilities. Changes may be tested, and 
approved in development and approval process. There may in fact be no changes to the files at a 
particular time, and the system can recognize this. In such cases, after identifying the absence of 
changes, there^isno ftirther processin g until^ e^next time possi^ would be identified. 

30 The content distributor identifies the changes to the files (Step 181). Changes to the files 



can be identified in a number of ways. In one embodiment, the content designer provides a 
manifest, which is a list of changes. The designer keeps track of the changes, and manually 
identifies the changes to the content distributor, for example using the content control user 
interface 126, or by communicating a manifest to the content distributor 125. In another 
5 embodiment, the software and systems used by the content designer to design the content tracks 
changes and provides a manifest of changes that are communicated to the content distributor 125. 

In another embodiment, the content distributor 125 integrates with the operating system 
file services and monitors changes to the source file set. In one such embodiment, a software 
device dri ver "monito r" is installed that is invoked by the operating system to perform' file 
10 operations. The device monitor acts as a pass-through device driver that passes data between the 
operating system and the actual device driver (i.e. hard disk driver software). In addition to 
passing the disk I/O commands through to the disk driver, the device monitor observes those I/O 
iij.f commands, and records changesjojhgj^^ In one embodiment, the device monitor is 

1 J int egrated \yith the content distributor 125. In another embodiment, the device monitor produces 
:,|5 a manifest that is communicated to the content distributor 125. 

;^ = In yet another embodiment, the content distributor 125 performs a comparison between a 

cu rrent s ource file set and a previ ous source file set to determine the cha nges to th e source file 
= =i set. The content distributor maintains a list of the files that were present the last time that an 
j' update was made for comparison purposes. This list includes the file name and other file 
j;]20 properties, such as the file size, the date/time that the file was last modified, a hash code of the 

i : I 

: j;i contents, the permissions and/or access control restrictions, and user/group ownership. In one 

embodiment, the list of files includes a complete copy of every file in the previous source file set, 
however, for large file systems this embodiment is very inefficient. In a more efficient 
embodiment, only a list of the previous files and certain file attributes are needed, as described 

25 below. The steps of identifying changes (STEP 181), transmitting changes (STEP 182), and 
installing the changes (STEP 183), are sometimes referred to as an update. 

Referring to FIG. 4, in one embodiment, the comparison between the source file set and 
the previous file set takes place by analysis of the files (and directories) in the source file set. For 
each file in the source file set (STEP 190), the content distributor compares the files in the source 

30 file set v^th the information describing the previous source file set, which in one embodiment is 



in the form of a list as described above. For each file, the content distributor determines if the 
file is in the previous source file set list (STEP 191). If it is not, the file is listed as a new file 
(STEP 192), indicating that the file has been added to the source file set, and a hash is calculated 
on the file (STEP 193). If the file is listed, the file listing is marked (STEP 194) to indicate that 
5 the file is still included in the file set. This is later used to determine if any files on the previous 
list are missing, that is whether they have been deleted. 

The size of the file is compared to the information in the list (STEP 195). If the file size 
is different, the file is considered to be modified, and is listed as such (STEP 196). A new hash 
of the file is calculated and stored in the list (STEP 193). If the size is the same, the date/time is 
10 compared (STEP 197). If the date/time is different, the hash of the file is calculated and 
compared to the hash included in the previous list (STEP 198). In this context, a hash is a 
calculation made on the content of the file that results in a single number that is related to the file 
O content. Such a hash is also referred to as a message integrity code. Examples of hash codes are 
! : I checksums and a cyclic redundancy codes. If the hash of a file is different, the file is listed as 
C)5 modified (STEP 196), and the new hash is stored (STEP 193) in the list. Otherwise, if the file 
attributes (owner, group, etc.) have changed (STEP 199), the file is listed as having modified 
1-^ attributes (STEP 200). 

f 1 In one embodiment, if the file contents have not changed, the system also determines 

whether file attributes changed (Step 199). In another embodiment, attribute information is sent 
i:]-20 as a part of the content update. When these steps have been completed for all files in the source 
.; ];] file set, markings fi*om STEP 194 are checked to see if any files that were previously listed are 
now missing, meaning that they have been deleted fi*om the file set (STEP 200). Files not 
marked are listed as deleted (STEP 202). 

Changes :to the source file set are identified to the content distributor 125 in a change list, 
25 a lso referred to a s a manifest. In one embodiment, the manifest contains entries that indicate 
changes to a file such as additions, deletions, content modifications, and/or attribute 
modifications. For example, the add statement "ADD source/dir/dir/filel" indicates that a file 
filel has been added, and the statement "CHMOD source/file2" indicates that permissions 
associated with file "file2" have changed. Other statements include "DELETE" to indicate 
30 removal of a file, and "MODIFY" to indicate a change of content. Additional attribute 



differences also use the CHMOD statement, or might have specific statements of their own, such 
as CHOWN for a change of ownership, or CHGRP for a change of group association. 

Referring to FIG. 5, in one embodiment, a manifest entry 300 includes at least eight 
information elements 301-308. In one embodiment, each entry is stored in a text format, so that 
5 the information can be read by a system operator with a simple text editor or interpreted by other 
software. In another embodiment, each entry is stored in binary format that contains the same 
information as in the text format, but is more compact. The binary format can be converted with 
a conversion tool to the text format. The text format can also be converted to a binary format. 
In one embodiment, the manifest entry 300 includes a file type field 301. Possible file 
10 types are directory, file, symbolic link, hard link, or end-of-directory marker, which comes after 
the last file in a directory. In a text embodiment, each file is described with a three letter code 
such as "DIR" for directory, "END" for end-of-directory marker, "NRM" for normal file, "LNK" 
'i for a symbolic link, and "HLK" for a hard link. In a binary embodiment, each choice is 
i I represented by an integer code. For example, in one embodiment, a directory is represented by 
,i5 the number 1, and a file is represented by a 2, and so on. 

' The manifest entry 300 also includes an action taken field 302. In the text embodiment, 

1-=^ the action taken is a three letter code, such as "ADD" for an added file, "CHG" for changed 
• =1 content, "CHP" for changed owner, group, or permissions, and "DEL" for a deleted file. The 
f three letter code "NOC" is used to describe a file that has not changed. In a binary embodiment, 
ii20 each choice is represented by an integer code. For example, in one embodiment, an added file is 
i n represented by the number 1, a changed content is represented by a 2, and so on. 

The manifest entry 300 also includes a permission field 303, which describes the file 
access permissions, as well as other information about the file. In a text embodiment, the 
permissions are stored, UNIX-style, as four 3-item binary entries (i.e. rwxrwxrwx), where the 
25 first 3 -item entry describes whether an executable program will run as the user, and the following 
three entries show read, write, and execute permissions for the owner, group, and public, 
respectively. In a binary embodiment, the permission information is stored as a binary integer 
that is the four-digit octal number that represents the permissions. 

The manifest entry 300 also includes a file size field 304, which describes the size of the 
30 file. In a text embodiment, the file size is written in ASCII characters. In a binary embodiment. 



the file size is stored as an integer. 

The manifest entry 300 also includes a date/timestamp 305. In a text embodiment, the 
date and time are written in ASCII characters. In a binary embodiment, the date/time is stored as 
an integer representing the number of seconds since midnight January 1, 1970. 
5 The manifest entry 300 also includes ownership information 306. This information 

includes two parts — ^the user identifier of the file owner, and the group identifier of the group 
owner. In a text embodiment, the owner and group identifiers are stored as ASCII strings. In a 
binary embodiment, the owner identifier and group identifier are each stored as integers. 
The manifest entry 300 also includes a checksum 307 or hash result. In a text 
10 embodiment, this is stored as an ASCII string. In a binary embodiment, the checksum is stored 
as an integer. The manifest entry also includes the relative path name 308 of the file. In both 
text and binary embodiments, the relative path name 308 is stored as an ASCII string. 

Referring to FIG. 6, an example list of changes shows added files aaa (which is a 
g I directory), files agent.reg, questd.reg, and sqlserver,reg in directory aaa, and files bbb and ccc, 
::. 15 which are also directories. Directory ddd, and files abc and efg in directory ddd are unchanged. 
Directory efg is also unchanged. Directories mmm, xxx, and yyy are deleted, and files agent.reg, 
questd.reg, and sqlserver.reg are deleted firom directory xxx. 
r J Referring to FIG. 7, an example of a text embodiment of a manifest of the format of 

l -f FIG. 5 reflects the changes listed in FIG. 6. In the first entry, ENTRY 1, the directory aaa is 
y20 listed in the file name 308. The file aaa is listed as type 301 "DIR." The action 302 for this file 
is "ADD," indicating that the file was added. The permissions 303 are listed UNIX-style, and 
show that the file is a directory, and that the owner has read, write, and execute permissions. The 
file size 304 is listed as zero. The date/timestamp 305 of the file is listed as May 27 17:12. The 
user and group identifiers 306 are both listed as identifier 0. The checksimi of the file 307 is 
25 zero. 

In the second entry, ENTRY 2, the file listed in the file name 308 is agent.reg. This file, 
agent.reg. Because ENTRY 2 is between the aaa directory entry (ENTRY 1) and the END 
statement (ENTRY 5), this file is in directory aaa. The file agent.reg is of type 301 normal, and 
was added as new file, as shown in the action element 302. The permissions 303 indicate that the 
30 owner has read and write permission. The file size 304 is 569 bytes. The date 305 of the file is 



May 11, 1998. The user and group identifiers 306 are both zero. The checksum 307 is 
3564886220. 

The fifth entry, ENTRY 5, is of type 301 END marker, which indicates the end of listings 
for directory aaa. The sixth entry, ENTRY 6, directory bbb is not a subdirectory of aaa, because 
5 it is listed after the aaa END marker. 

Referring again to FIG. 3, in one embodiment, the content distributor creates the 
manifest, for example by determining the changes using the method of FIG. 4. In another 
embodiment, the manifest is communicated to the content distributor. In one embodiment, the 
manifest is communicated by storing the manifest in a particular location (i.e. directory and 
10 filename), where the content distributor is configured to find it. In another embodiment, the 
manifest is communicated to the content distributor by explicitly transmitting it to the content 
distributor 125 over a network. 

0 After the changes have been identified (STEP 181), for example using the embodiment of 

1 l l FIG. 3, the changes are transmitted to the agent (STEP 1 82). Often, the changes are mapped to a 
is particular directory on the host file system. In one embodiment, the source file set is mapped to 

the various hosts' file systems as shown in the example in Table 1 : 



Source Host 


Source Directory 


Destination Host 


Destination Directory 


staging . atre ve .com 


/usr/netscape/docs/app 1 


www 1 .atreve.com 


/usr/netscape/docs/app 1 






www2.atreve.com 


/docs/current/app 1 






www3 .atreve.com 


/usr/netscape/docs/a 1 


Table 1-] 


Example Mapping of Source Directory to Destination Host Directory 



20 As can be seen fi:om Table 1 , the system administrator can map the files in the source file set 
from the staging server file system to the file systems on the various web servers. Use of the 
actual file system identifier, and not a URL, allows mappings of shared libraries and other files 
that may not be identifiable with a Uniform Resource Locator ("URL"). For example CGI 
scripts might not be mapped if a URL was used since such files generally are not available from 

25 the web server via web page requests, and so do not have a URL. It would be possible to use the 
URL instead of the file system identifier, so that the mapping is not necessary, but at the tradeoff 



of restricting the type of files that can be modified. If URLs were used, only files that were 
accessible fi-om the web server via web page requests would be accessible. 

In one embodiment, the files in a source file set directory hierarchy are combined into a 
single archive file, and that archive file is compressed. Any file that is larger than a configurable 
5 value is divided into smaller blocks for more efficient commxmication across the network to the 
host systems and to reduce the impact on the network. Dividing the files into smaller blocks 
minimizes the amount of retransmission in case of a timeout. An example of such a configurable 
value is one megabyte. 

A change list (manifest), including the file sizes of the changed files is sent to each agent 
10 that is to receive the content. The agent determines whether there is sufficient disk space for the 
update, based on the file sizes in the change list and the computation the agent knows it will need 
to perform. For example, the agent may determine whether there is enough room v^thin the file 
Q system to store the compressed copy of the content updates, and two copies of the imcompressed 
I ; I data, a temporary copy and the copy to be stored. In this way, the agent is able to abort transfer 
: ;15 before the host has become overloaded with the new content. 

When a predetermined number of servers have agreed to receive the updated content, the 
data is sent firom the content distributor to the agents. If too many agents are unable to receive 
the content, the content distributor may abort the job. The percentage of agents required for a 
transfer to take place is configurable. For example, the system operator may determine that the 
m:20 transfer should not take place unless 50% of the agents are able to accept the changes. It is 
'j-J possible in this way to prevent having too few servers that have the updated content. 

In one embodiment, transfer occurs using a standard TCP/IP transport, such as file 
transfer protocol ("FTP"). In another embodiment, transfer occurs using a reliable multicast 
protocol. If there are transmission failures, a block of data is resent. If the transfer fails 
25 repeatedly, the transfer is aborted, and various action can be taken including alerting the system 
operator. Again, the content distributor may abort the installation of the changes if due, to 
unforeseen circumstances, fewer agents succeeded at the transfer than were expected to. If, for 
example, many of the agents lose network connectivity, it would be possible to have an 
insufficient number of agents available to serve the new content. 
30 Referring again to FIG. 1, if an update fails for a particular agent 106, the web service 



system 90, will attempt to "route aroxmd" the affected part of the system. In an embodiment 
where the content distributor is separate from the manager, the content distributor 125 informs 
the manager 1 10 that the agent 106 has failed. The manager 110 communicates with the traffic 
manager 120, so that the traffic manager will not direct web page requests to the web servers 102 
5 communicating with that agent 106. The manager 110 may also direct traffic away from the web 
servers 102 onto other servers. 

In one embodiment, the content distributor 125 will create a "catch-up" update package 
targeted to the failed destination agent. The catch-up update package contains the changes that 
should have, but have not, reached the agent; initially, this is the list of changes from the first 
10 update to fail in transmission. This catch-up update package may grow if subsequent updates 
also fail to reach the same agent. When an update package fails, the agent will not receive other 
updates until a "catch-up" update completes, because there may be dependencies from new 
Q updates on changes which earlier failed to propagate. 

\j\ Referring again to FIG. 3, once the changes have been transmitted to the agent 1 82, the 

Is changes are installed (STEP 183). The agent 106 and the web server interface 104 cooperate to 
install the content. When the new content has been received, the agents reassemble, and then 
1- i: uncompress, the update packages, and place the data in a temporary data store. The agents then 
P-, wait for a signal from the contentdistf ^u^ ^ begin copying the files tcrd ie server.content 

^ directories^When the signal is received, the ch anges are made to the server conlentjdireiiLtories. 
iJIO Also, any files listed for deletion are removed at this time. When the update is successfiil, the 
agents inform the content distributor that they have succeeded in updating the files. In one 
embodiment, the copying is accomplished with a simple overwrite. In another embodiment, the 
old files are first renamed and/or stored in an altemate directory. This allows the change to be 
quickly reversed, but v^th the tradeoff of requiring more data storage. If copying fails for any 
25 reason, the agents will alert the content distributor of the problem. Either the agent or the content 
distributor will also alert the Manager, which may then instruct the traffic manager to avoid the 
failed agent. In one embodiment, the agents maintain a version identifier, which indicates the 
content state of the web server. In one embodiment, the version identifier is an integer value. 
In one embodiment, the web server is paused or stopped during the update process. 
30 When the files are copied to the web server content directories, the web servers are prevented 



• # 



from handing web page requests in order to prevent requesters from receiving inconsistent 
content. The web servers are coordinated to redirect users during the content update process. 
This is accomplished by the manager directing the traffic manager not to forward requests to that 
web server. At the same time, requests which do reach that web server 102 may be redirected by 
5 the web server interface 104 from that web server 102 to the traffic manager 120 or to another 
web server 102. Users in the middle of a transaction may be given a predetermined amount of 
time to complete the transaction before being redirected. Once the web server has been flushed 
of requesters, the update will take place. If application binary files are not being changed, the 
web server can be flushed of requesters, and then requesters can be directed to the server once the 
10 content transfer is complete. If application binary files are modified, however the web server 
may need to be restarted. 

In some cases, it may not be possible to disable web servers in order to update content. 
The process of temporarily redirecting the browsers can be very time consuming, and that time, 
j j I combined v^th the time required to transfer files and update the web server can be unacceptably 
:/|5 large. To maximize server availability, the content can be updated while the web server 

' continues to respond to requests. This is achieved by creating a copy of the files that will be 
1-^^ changed, and putting the copy of those files in a place accessible to the web server. The agent 
P i directs the web server interface to intercept all requests for files that are changing. Requests for 
!=^=^ files that are not changing can be directed to the usual content area. Requests for files that are 
=J:^0 changing can instead be directed to the stable copy, wWle the new files are installed in the usual 
. j i area. After the agent has completed modifications to the files, the web server interface can be 
signaled to again use the normal area. Users who, at the time of switchover from the old to the 
new content, are involved in a transaction that involves a series of related web pages may need to 
continue to access the "old" content for some time after the switchover, imtil the transaction is 
25 complete. For example, a user in the middle of a purchase at a first price should not complete the 
transaction v^th a web page that is using an updated, different price. 

In one embodiment, to ensure transaction integrity, each changeover is assigned a version 
identifier. In one embodiment, the version identifier, also referred to as a checkpoint identifier, 
is an integer that changes by being incremented v^th each content update. The web server 
30 interface intercepts web page requests based on the version expected by the browser, and 



provides the content for that version. To do this, the web server needs to know the version that is 
desired by the browser. In one embodiment, this information is included in the URL. However, 
this has the disadvantage of making the URLs and file structure more complicated. Also, the 
version change is less transparent to the user. 
5 In one embodiment, the web server issues a cookie to a browser that includes a version 

identifier that specifies the then-current version of the pages served by the server to that browser. 
A cookie is a special text file that a web server sends to a browser so that the web server can 
"remember" something about that browser. Using the Web's Hypertext Transfer Protocol 
(HTTP), each request for a Web page is independent of all other requests. For this reason, 
10 without a mechanism such as a cookie, the web server has no knowledge of what pages it has 
sent to a browser previously or anything about the browser's previous visits. A cookie is a 
mechanism that allows the server to store its own information about a browser on the browser's 
Q own computer, and access that information when the user makes a web page request. Cookies 
h i can be provided with an expiration duration, meaning that they will be discarded by the browser 
is after a period of time. 

0^ In one embodiment, an example of such a cookie is implemented as the code: "Set- 

|.=^ Cookie: AtreveBCD=37; expires=Thursday, 20-January-1999 12:32:34 GMT; path=/" This code 
is sent fi-om the web server to the browser. The browser will, when communicating with web 
servers in the same domain, include the line "Cookie: AtreveBCD=37" for all requests to any 
ij20 path, until 12:32:34 GMT, on 20-January-1999. The "Set-Cookie" and "Cookie" parts of the 
j i J protocol are headers according to the HTTP specification. The "AtreveBCD" is the name of the 
cookie. Any other name can be used; AtreveBCDis the default. The "37" is the value of the 
cookie, which is the checkpoint that the server has now, and will (because of the web server 
interface) continue to offer until the expiration time. The code "Expires" sets that expiration 
25 time. In the example, the expiration time is 20- January- 1999. The "Path" code can be used to 
limit which pages give the cookie, but the indicates it that it will cover all files. 

The cookie that the web server issues to the browser effectively allows the browser to 
request content fi-om the web server and indicate the version identifier for that content. Thus, if 
the browser makes six requests with a particular cookie specifying a particular URL, those six 
30 requests thus will be self-consistent, even if the agent has in the meantime delivered new 



version(s) of content to the web serverl02. 

In one embodiment, the earlier content is not discarded until all cookies that specify that 
content have been discarded. The content is stored in a "backup area" which contains the 
changes from a version to the next version. For example, the files that change in a transition 
5 from version 2 to version 3 will be stored in the version 2-3 backup area. The web server 

interface will direct web page requests for version 2 that changed in the transition from version 2 
to version 3 to the appropriate content in the appropriate backup area. 

Referring to FIG. 8, in a simplified example, a web server has content with a current 
version identifier of 34. Previous versions for which cookies are still valid are versions 33 and 
10 32, The current version, version 34, contains files A and B, which were modified in version 34; 
file C, which was modified in version 28; and file D, which was modified in version 25. File A 
was modified in every version shown in the figure, including version 32, version 33, and version 
O 34. File B was modified in version 30, version 32, and as stated above, in version 34. The 
j i I change from version 3 1 to version 32 thus included changes to files A and B, and deletion of file 
is E, which was created in version 1 . Therefore, in the 3 1-32 backup area, which contains the files 
: = that changed in the transition from version 3 1 to version 32, is version 3 1 of file A, version 30 of 
file B, and version 1 of file E are stored. The change from version 32 to version 33 included 

ti: 

r i modification of file A, so in the 32-33 backup area, version 32 of file A is stored. The change 
l'^^ from version 33 to version 34 included modification of files A and B, and deletion of file F 
ius^O (which was added in version 10), so in the 33-34 backup area are stored version 33 of file A, 
Jl version 32 of File B, and version 10 of file F. 

If a web server requests content, for example by presenting a cookie that indicates a 
content version other than the current version, and if that file was changed between that older 
checkpoint and the current one, the web server interface may direct the web server to take the 
25 content from an area other than the current version area. In one embodiment, the web server 
interface reviews the change lists to determine if the requested file has changed, and if it has 
changed, what backup area it is located in. For example, still referring to the example of FIG. 8 
in which the current version is version 34, if the web server receives a request for file A, and the 
cookie indicates that the browser is looking for version 32, the web server interface will see that 
30 file A was modified as part of version 33. Version 32 of file A therefore is located in the 32-33 



backup location. If the web server receives a request for file B from the same browser (with the 
same version 32 cookie), the web server interface will determine that file B changed for version 
34, and so version 32 of file B is stored in the 33-34 backup area. If the web server receives a 
request for file D, the web server interface will determine that the file has not been modified 
5 since version 32, and that file can be obtained from the current version area. 

In one embodiment, the content distributor provides for scheduled updates of source file 
set changes to a particular time or time interval. The content distributor can also update upon a 
manual command of the system operator. In one embodiment, the update is specified by: a 
content mapping indicating where files should be copied from (i.e. the source file set) and where 
10 they should be copied to (i.e. the file servers' file systems); a start/date time or time interval 

indicating when the update should take place; whether only the changed files should be updated 
(as described above) or whether all files should be copied; the action that should be taken upon a 
^-=1 failure; whether the server should be restarted upon content update; whether the server should be 
i.i I paused or stopped during the content update; whether the update is enabled or disabled (to allow 
=.15 the system operator to disable a scheduled update); and the percentage of servers that need to 

' accept the update before the servers will be instructed to make the change. In one embodiment, 
1-=^ the update is referred to as a job. 

j; J For example, it is possible to specify an update that runs every ten minutes, updates the 

f'^ files that have changed, and notifies a system operator of any problems. It is also possible to 
y^20 specify an update once a month. In one embodiment, the system tums off the servers while 
u;i copying the files, updates all the changed files and restarts the servers when the content has been 
updated. 

Referring to FIG. 9, some web service systems 90 have one or more associated caching 
servers 200. A caching server 200 is a type of web server that is located between the requester 

25 201 (for example, a browser) and the web service system 90. The caching server 200 initially 
does not have any content. Rather, it requests web pages upon demand from the requester 201 
and stores the web pages in its cache. One example of a commercially available caching server 
is the NETCACHE product available from Network Appliance, Inc. of Santa Clara, California. 
The caching server 200 receives a web page request from a browser 201 for content located in 

30 web service system 90. Based on the request and its own configuration, the caching server 200 



requests the web page from the original web server (web service system 90) that has the web 
page. The caching server 200 receives the web page from the original web server 90, and 
transmits the web page to the browser 201 . The caching server 200 also stores that web page for 
a predetermined period of time. The period of time for which the page is stored is a time period 
5 determined by either the content provider (the original web service system 90) by, for example, 
specifying an expiration period with the delivery of the document according to the HTTP 
protocol, or by the caching server 200 system administrator. If a second request, from the same 
requester 201 or a different requester, arrives at the caching server 200 for that web page within 
the expiration period, the caching server can retransmit the web page in response to the request 
10 without making requesting the content from the original server. Thus, the request is fixlfilled 
without placing fiirther demands on the original server or the network vAth the second request. 
When files change on the web service system 90, as described above, files cached on the 
O caching server 200 may not have expired. In that case, the caching server 200 continues to 
Ij J provide an earlier version of a web page than the updated version that is available from the web 
=.15 service system 90. It is therefore useful to use change lists, such as those described above, to 
; = ' notify a caching server 200 that files have changed. 

Referring to FIG. 10, in a system in which file changes are coordinated wdth a caching 
: i server 200, changes are made to files (STEP 180), changes are identified (STEP 181), changes 
[ are transmitted (STEP 182) to the web servers, and changes are installed (STEP 1 83). A caching 
^ilO server is also notified (STEP 1 84) of the changes. The additional step of notifying the caching 
: ii server (STEP 184) allows the caching server to disregard (i.e. flush) the obsolete web page. 

There can be one caching server, or many caching servers, and they can be notified using various 
communication techniques. For example, in one embodiment, a broadcast message is used. In 
another embodiment a separate message is transmitted to each caching server. In yet another 
25 embodiment, a file is stored in a directory available to one or more caching servers. 

Referring to FIG. 1 1, an embodiment of the method of FIG. 6 can include making the 
changes (STEP 180) identifying the changes (STEP 181), and notifying the cache (STEP 184). 
In one embodiment, the notification (STEP 184) includes converting the change list to Uniform 
Resource Locators ("URL") to identify content (STEP 186). Browsers use URLs to identify 
30 content. As described above, in one embodiment, the change lists are described in terms of 



directories and files in the host file system, because this is more convenient for Web Servers and 
allows indication of all files in the most file system. When providing changes to a caching 
server, it is usefiil to convert the change list that lists files (and directories) into a format that 
includes the URL. It is possible that a source directory corresponds to a particular prefix of 
5 possible URLs. For example, the content directory and file 

"C:\WEBSPECTIVE\HOME\ABOUT.HTML" might correspond to the URL 
"http://wvm.webspective.com/home/about.html". This implies that the prefix would have to be 
modified (in this case C:\WEBSPECTIVE replaced with http://wvm.webspective.com), and the 
directory separator, in this case the backslash "\" replaced with the URL standard forward slash 
10 "/". In addition, characters which are not allowed in URLs, such as spaces, are encoded 

according to a specified rule. An example of such character replacement is described in the IETF 
Network Working Group RFC- 1783 document entitled "Uniform Resource Locators" by T. 
Bemers-Lee et al. For example, spaces can be encoded with "%20", and this translation 
Li,| concatenated onto the URL prefix. 

V; is Once the list items have been converted into URL format, the list of altered URLs is sent 

; to the caching server (STEP 187). The caching server can use this list to discard outdated 
1 = = content. As shown in FIG. 7, it is not necessary to perform content propagation to perform the 
notification. For example, even if there is only one web server, but many caches, the system of 
; ' ; FIG. 7 will serve to notify one or more caching servers of the changes. As shown in FIG. 7, the 
:i:20 changes are made (STEP 180), the changes are identified (STEP 181), and the list of changes are 
iji then converted to URLs (STEP 186). Those changes are transmitted to the caching server (STEP 
187). In another embodiment, the conversion to URLs (STEP 186) takes place between the time 
that the changes are made (STEP 180) and the change identification step (STEP 181). 

Referring to FIG. 12, in one embodiment, method of FIG. 3 and FIG. 10 further includes 
25 running a user configurable script. After changes are made (STEP 180), the user configurable 
script is run (STEP 280). After changes are identified (STEP 181), the user configurable script is 
run (STEP 281). The script runs simultaneously with the transmission of the changes (STEP 
182). After changes are transmitted (STEP 182), the user configurable script is run ^igain (STEP 
282). The user configi roble script can be used to accomplish content distribution tasks that are 
30 specific to a customer's implementatio n. The user configurable script is run through the 



appropriate call to an operating system function. 

Referring to FIG. 13, in one embodiment, information is provided to the callout script. In 
one embodiment, the information is provided to the script on the standard input. In another 
embodiment, the information is provided in a file. The script returns either a successful (zero) 
5 status code, or a non-zero error code, which in one embodiment v^ll abort the operation. 

In one embodiment, the information 400 is provided in a text format, beginning with a 
BEGINP ARAMS statement 401, and ending with an ENDPARAMS statement 420. The 
information 400 includes the version number 402 of the information block, which is used for 
compatibility. The information 400 includes the name of the job 403, which in this example is 
10 EXAMPLEJOB. 

The information 400 includes the state of the job 404, which can be one of BEGIN, IN 
PROGRESS, and END. A BEGIN value indicates that the script is called before the changes are 
a identified (i.e. STEP 280 of FIG. 11). An IN PROGESS value indicates that the script is called 
I : | after the changes are identified, but before (or as) the changes are transmitted (i.e. STEP 281 of 
.'is FIG. 1 1). An END value indicates that the transmission is complete (i.e. STEP 282 of FIG. 11). 

' The information 400 includes the name of the mapping 405, which in this case is ALLIMAGES. 
I i= The information 400 includes the path name of the manifest file 406, which in this example is 
Jl l /TMP/STAGING/23423.TXT. In the example, the manifest is a text file, which implies that it is 
in the text embodiment described above. In one embodiment, the manifest is stored in the binary 
;J:20 embodiment, as is converted to a text file before the script is called. 

The information 400 includes the source file set directory 406, and a revert directory 408, 
which can hold an earlier version of files (before changes), or can contain any content that should 
be automatically reverted to. An array of destinations 409 is indicated. Each array element 
includes information about a destination for the files. In this example, there are two destination 
25 hosts, OOLONG and DARJEELING. The first element of the array begins v^th a 

BEGINELEMENT statement 410 and ends with an ENDELEMENT statement 414. The array 
element includes the name 41 1 of the destination host, which in this case is OOLONG. The 
array element includes the destination directory 412 on the destination host, which in this 
example is /HOME/HTTPD-OOLONG/DOC/IMAGES. The array element includes the state of 
30 the transfer 413, which in this example is NORMAL. The second element of the array begins 



with a BEGINELEMENT statement 415 and ends with an ENDELEMENT statement 419. The 
second array element includes the name 416 of the destination host, which in this case is 
DARJEELING. The array element includes the destination directory 417 on the destination host, 
which in this example is /HOME/HTTPD-DARJEELING/DOC/IMAGES. The second array 
5 element includes the state of the transfer 418, which in this example is NORMAL. Thus the 
information provided to the user script allows the same script to be called at different times 
during the execution of a job, and the script can take different actions depending on the 
parameters provided. 

Variations, modifications, and other implementations of what is described herein will 
10 occur to those of ordinary skill in the art without departing from the spirit and the scope of the 
invention as claimed. Accordingly, the invention is to be defined not by the preceding 
illustrative description but instead by the spirit and scope of the following claims. 
=^ WhsA is claimed is: 



